home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xkbevd.z / xkbevd
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXKKKKBBBBCCCCOOOOMMMMPPPP((((1111))))          XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666))))           XXXXKKKKBBBBCCCCOOOOMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xkbevd - XKB event daemon
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxkkkkbbbbeeeevvvvdddd [ options ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           This command is very raw and is therefore only partially
  16.           implemented;  we present it here as a rough prototype for
  17.           developers, not as a general purpose tool for end users.
  18.           Something like this might make a suitable replacement for
  19.           xev;  I'm not signing up, mind you, but it's an interesting
  20.           idea.
  21.  
  22.           The _x_k_b_e_v_d event daemon listens for specified XKB events and
  23.           executes requested commands if they occur.   The
  24.           configuration file consists of a list of event
  25.           specification/action pairs and/or variable definitions.
  26.  
  27.           An event specification consists of a short XKB event name
  28.           followed by a string or identifier which serves as a
  29.           qualifier in parentheses;  empty parentesis indicate no
  30.           qualification and serve to specify the default command which
  31.           is applied to events which do not match any of the other
  32.           specifications.  The interpretation of the qualifier depends
  33.           on the type of the event:  Bell events match using the name
  34.           of the bell, message events match on the contents of the
  35.           message string and slow key events accept any of _p_r_e_s_s,
  36.           _r_e_l_e_a_s_e, _a_c_c_e_p_t, or _r_e_j_e_c_t.   No other events are currently
  37.           recognized.
  38.  
  39.           An action consists of an optional keyword followed by an
  40.           optional string argument.  Currently, _x_k_b_e_v recognizes the
  41.           actions: _n_o_n_e, _i_g_n_o_r_e, _e_c_h_o, _p_r_i_n_t_E_v_e_n_t, _s_o_u_n_d, and _s_h_e_l_l.
  42.           If the action is not specified, the string is taken as the
  43.           name of a sound file to be played unless it begins with an
  44.           exclamation point, in which case it is taken as a shell
  45.           command.
  46.  
  47.           Variable definitions in the argument string are expanded
  48.           with fields from the event in question before the argument
  49.           string is passed to the action processor.   The general
  50.           syntax for a variable is either $_c_P _o_r $(_s_t_r), _w_h_e_r_e _c _i_s _a
  51.           _s_i_n_g_l_e _c_h_a_r_a_c_t_e_r _a_n_d _s_t_r _i_s _a _s_t_r_i_n_g _o_f _a_r_b_i_t_r_a_r_y _l_e_n_g_t_h.
  52.           _A_l_l _p_a_r_a_m_e_t_e_r_s _h_a_v_e _b_o_t_h _s_i_n_g_l_e-_c_h_a_r_a_c_t_e_r _a_n_d _l_o_n_g _n_a_m_e_s.
  53.  
  54.           The list of recognized parameters varies from event to event
  55.           and is too long to list here right now.   This is a
  56.           developer release anyway, so you can be expected to look at
  57.           the source code (evargs.c is of particular interest).
  58.  
  59.           The _i_g_n_o_r_e, _e_c_h_o, _p_r_i_n_t_E_v_e_n_t, _s_o_u_n_d,and _s_h_e_l_l actions do
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXKKKKBBBBCCCCOOOOMMMMPPPP((((1111))))          XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666))))           XXXXKKKKBBBBCCCCOOOOMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74.           what you would expect commands named _i_g_n_o_r_e, _e_c_h_o,
  75.           _p_r_i_n_t_E_v_e_n_t, _s_o_u_n_d, and _s_h_e_l_l to do, except that the sound
  76.           command has only been implemented and tested for SGI
  77.           machines.   It launches an external program right now, so it
  78.           should be pretty easy to adapt, especially if you like audio
  79.           cues that arrive about a half-second after you expect them.
  80.  
  81.           The only currently recognized variables are _s_o_u_n_d_D_i_r_e_c_t_o_r_y
  82.           and _s_o_u_n_d_C_m_d.  I'm sure you can figure out what they do.
  83.  
  84.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  85.           ----hhhheeeellllpppp   Prints a usage message that is far more up-to-date
  86.                   than anything in this man page.
  87.  
  88.           ----ccccffffgggg _f_i_l_e
  89.                   Specifies the configuration file to read.   If no
  90.                   configuration file is specified, _x_k_b_e_v_d looks for
  91.                   ~/.xkb/xkbevd.cf and $(LIBDIR)/xkb/xkbevd.cf in that
  92.                   order.
  93.  
  94.           ----sssscccc _c_m_d Specifies the command used to play sounds.
  95.  
  96.           ----ssssdddd _d_i_r_e_c_t_o_r_y
  97.                   Specifies a top-level directory for sound files.
  98.  
  99.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  100.                   Specifies the display to use.  If not present,
  101.                   _x_k_b_e_v_d uses $DISPLAY.
  102.  
  103.           ----bbbbgggg     Tells _x_k_b_e_v_d to fork itself (and run in the
  104.                   background).
  105.  
  106.           ----ssssyyyynnnncccchhhh  Forces synchronization of all X requests.  Slow.
  107.  
  108.           ----vvvv      Print more information, including debugging
  109.                   messages.   Multiple specifications of -_v cause more
  110.                   output, to a point.
  111.  
  112.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.           X(1)
  114.  
  115.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  116.           Copyright 1995, Silicon Graphics Computer Systems and X
  117.           Consortium, Inc.
  118.           See _X(_1) for a full statement of rights and permissions.
  119.  
  120.      AAAAUUUUTTTTHHHHOOOORRRR
  121.           Erik Fortune, Silicon Graphics
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.